home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga3 / pvtree12.lha / pvtree / PVTree.doc < prev    next >
Text File  |  1993-12-16  |  8KB  |  264 lines
  1.  
  2.  
  3.        **************************************************************
  4.        *                                                            *
  5.        *  PVTree, PVTreeGUI, PVTreeMUI V1.2 ⌐ 1993 by Pascal Pensa  *
  6.        *                                                            *
  7.        *                FreeWare but CopyRight'ed !                 *
  8.        *                                                            *
  9.        **************************************************************
  10.  
  11.  
  12.  
  13. Introduction
  14.  
  15.     PVTree is an utility to see the full (or part) directory tree of any 
  16.     disks devices like HardDisk, Floppy Disk, Ram,... in a graphic window
  17.     which can be printed. HardLinks supported.
  18.  
  19.     It can be used from the Shell or from PVTreeGUI or PVTreeMUI who are
  20.     two GUI designed for PVTree. 
  21.  
  22.     PVTreeGUI use the standard intuition look.
  23.  
  24.     PVTreeMUI use the Magic User Interface from Stefan Stuntz, you must
  25.     have the "muimaster.library" (not provided) in your LIBS: directory 
  26.     and some new classes to run it. (see ReadMe.MUI)
  27.  
  28.     2.0+ system required !
  29.  
  30. General
  31.  
  32.     This utility is provided AS IS, and you are using PVTree at YOUR
  33.     OWN RISKS ! I'm NOT responsible of ANY DAMAGE that this utility
  34.     could make on your system !
  35.  
  36.     This utility is FreeWare but copyrighted :
  37.  
  38.         - It can't be put in a commecial product witout permission.
  39.  
  40.         - Files names and contain cannot be changed.
  41.  
  42.         - It can be packed.
  43.  
  44.         - It can be put on PD disks, FTP servers and BBS. All these
  45.           files MUST be distributed (normal form or packed with lha) :
  46.  
  47.                 - PVTree
  48.                 - PVTree.doc
  49.                 - PVTree.doc.info
  50.  
  51.                 - PVTreeGUI
  52.                 - PVTreeGUI.info
  53.  
  54.                 - PVTreeMUI
  55.                 - PVTreeMUI.info
  56.                 - ReadMe.MUI
  57.                 - ReadMe.MUI.info
  58.  
  59.  
  60.     For bug report, question, suggest, flame and so, contact me.
  61.     (see Author)
  62.  
  63.  
  64.  
  65. PVTree
  66.  
  67.     Options are:
  68.  
  69.         -f          Display all files, default : only dirs
  70.  
  71.         -d          Force the display to de dynamic
  72.  
  73.         -c          Use only 2 colors instead of 4
  74.  
  75.         -b          Change background color (ignored if -c is set)
  76.                                             (1-3 in normal mode)
  77.                                             (1-... in dynamic mode)
  78.  
  79.         -r <value>  Set the max subdir recusivity, default 10,
  80.                     range 2 - 99
  81.  
  82.         -s <name>   Set the name of the public screen to use
  83.  
  84.  
  85.         You can click on any file or dir name to have some informations 
  86.         on it.
  87.  
  88.         In the menu, 'Info' gives some informations about the root.
  89.  
  90.         By default the window use a superbitmap, so the scrolling is fast
  91.         but take a lot of chip memory.
  92.  
  93.         If you specify the -d option the tree is draw without superbitmap.
  94.         Only the visible tree is redrawn, so the scrolling is slow 
  95.         but take a few chip memory.
  96.  
  97.         You can use the -c option to keep some chip mem if you don't
  98.         use the -d option.
  99.  
  100.         You can use the arrow keys to move the display, if shifted, 
  101.         the move is faster. You can quit with the 'ESC' key.
  102.  
  103.         In the normal mode (NOT -d) you can print the tree by pressing
  104.         the 'p' key or by selecting the 'Print' menu item.
  105.  
  106.         You can also change the zoom scale from x1/4 to x4.
  107.  
  108.         If you have a black and white printer set the -c option.
  109.  
  110.         All others features are presents in the PrinterGFX preference
  111.         program, thanks Commodore !
  112.  
  113.         The -r option stops the root scan if the number of the 
  114.         subdirectory depth is greater than the -r value, including root.
  115.         Limits are 2 to 99 :-) .
  116.  
  117.         PVTree can be made resident. This is useful for floppy users.
  118.  
  119.  
  120. PVTreeGUI
  121.  
  122.         From Shell:
  123.  
  124.             PVTreeGUI [-options] [root directory]
  125.  
  126.  
  127.         Options:
  128.  
  129.             All of the PVTree's options and:
  130.  
  131.             -x <value>  Set the left of the GUI window
  132.  
  133.             -y <value>  Set the top of the GUI window
  134.  
  135.  
  136.         From WB:
  137.  
  138.             Supported ToolTypes :
  139.  
  140.             ROOT=name               The default root
  141.  
  142.             FILES=YES/NO            Like -f
  143.  
  144.             DYNAMIC=YES/NO          Like -d
  145.  
  146.             NOCOLOR=YES/NO          Like -c
  147.  
  148.             BACKCOLOR=n             Like -b
  149.  
  150.             MAXREC=n                Like -r
  151.  
  152.             LEFT=x                  Like -x
  153.             TOP=y                   Like -y
  154.  
  155.             SCREEN=name             Like -s
  156.  
  157.  
  158.         This program is very easy to use:
  159.  
  160.             - Write the root directory name in the string gadget
  161.               or click on the drawer icon to open a requester
  162.  
  163.             - Select options
  164.  
  165.             - Click on 'Draw'
  166.  
  167.         Be careful when you click on 'Draw' because this program simply
  168.         run the PVTree program in a backgroud process without waiting
  169.         the end of the PVTree's work. This is useful to display 
  170.         different tree at the same time.
  171.  
  172.         PVTree must be in the same directory than PVTreeGUI or in c:
  173.  
  174.  
  175.  
  176. PVTreeMUI
  177.  
  178.         From Shell:
  179.  
  180.             PVTreeMUI [-options] [root directory]
  181.  
  182.  
  183.         Options:
  184.  
  185.             -i          Start iconified
  186.  
  187.             -s          PVTree's screen
  188.  
  189.             Note: The -s option is simply given to PVTree,
  190.                   use the MUI prefs to set the PVTreeMUI's screen !
  191.  
  192.  
  193.         From WB:
  194.  
  195.             Supported ToolTypes :
  196.  
  197.             ROOT=name               The default root
  198.  
  199.             SCREEN=name             Like -s but this option is simply
  200.                                     given to PVTree, use the MUI prefs
  201.                                     to set the PVTreeMUI's screen !
  202.  
  203.             STARTICONIFIED=YES/NO   Start iconified, useful to put PVTreeMUI
  204.                                     in the WBStartup drawer, in this case don't 
  205.                                     forget the DONOTWAIT tooltype.
  206.  
  207.  
  208.         This program is very easy to use:
  209.  
  210.             - Write the root directory name in the string gadget
  211.               or click on the drawer icon to open a requester
  212.  
  213.             - Select options
  214.  
  215.             - Click on Draw or Multi Draw
  216.  
  217.         PVTree must be in the same directory than PVTreeMUI or in c:
  218.  
  219.         This program uses some MUI enhancements :
  220.  
  221.             - Gadgets can be activated with TAB, RETURN and up/down
  222.               arrow keys, quit with 'ESC'
  223.  
  224.             - Appwindow : simply drag a WB icon into the window
  225.               even if it's a file icon, the complete path will
  226.               appears in the string gadget
  227.  
  228.             - Iconify gadget : when iconified you can drop icons on 
  229.               it and the tree is drawn (multi draw)
  230.  
  231.             - Commodity : you can use the Exchange program to
  232.               iconify or quit
  233.  
  234.             - Look configuration via the MUI prefs tool (not
  235.               provided)
  236.  
  237.             - You can save/load the preferences with the menu
  238.  
  239.  
  240. Author
  241.  
  242.         Pascal Pensa                INTERNET : pensa@taloa.unice.fr
  243.  
  244.         11, Avenue Joliette
  245.         06100 NICE
  246.  
  247.         FRANCE
  248.  
  249.  
  250.  
  251.         Thanks to all the testers of the program, and bug reports.
  252.  
  253.         This program was writen using:
  254.  
  255.             - DICE C        (c) Matthew Dillon
  256.             - MUI1.4        (c) Stefan Stuntz
  257.             - 3.0 Dev. Kit. (c) Commodore Amiga, Inc.
  258.  
  259.                           n
  260.         And... an A500+  (:^(
  261.                           u
  262.  
  263.         Have fun, and please excuse me for my bad English...
  264.